home *** CD-ROM | disk | FTP | other *** search
/ Sprite 1984 - 1993 / Sprite 1984 - 1993.iso / man / cmds.fmt / migcmd.man < prev    next >
Encoding:
Text File  |  1990-03-09  |  7.1 KB  |  201 lines
  1.  
  2.  
  3.  
  4. MIGCMD                    User Commands                    MIGCMD
  5.  
  6.  
  7.  
  8. _________________________________________________________________
  9.  
  10. NNAAMMEE
  11.      migcmd - Print or update  information  relating  to  process
  12.      migration
  13.  
  14. SSYYNNOOPPSSIISS
  15.      mmiiggccmmdd [--ssSSZZppttTT] [--[[IIEE]] ((nnoonnee||aallll||rroooott))] [--[[iill]]  ((00||11))]  [--ll
  16.      ((00||11))] [--PP _n_u_m_R_e_c_s] [--dd _d_e_b_u_g_L_e_v_e_l] [--VV _m_i_g_r_a_t_i_o_n_V_e_r_s_i_o_n]
  17.  
  18. OOPPTTIIOONNSS
  19.      --ss                  A message is  printed  to  indicate  the
  20.                          status   of  process  migration  on  the
  21.                          current host,  including  the  migration
  22.                          level  and  the  conditions  under which
  23.                          migration is permitted.
  24.  
  25.      --SS                  Migration statistics are printed.  These
  26.                          include  such values as the average time
  27.                          to migrate an active process, the  aver-
  28.                          age  time  to perform a remote exec, and
  29.                          the total number  of  migrations,  evic-
  30.                          tions, and remote execs performed.
  31.  
  32.      --ZZ                  The  kernel  migrations  statistics  are
  33.                          reset to 0.
  34.  
  35.      --II                  Change the import restrictions for  pro-
  36.                          cess  migration.   (The  caller  must be
  37.                          root.)
  38.  
  39.      --EE                  Change the export restrictions for  pro-
  40.                          cess  migration.   (The  caller  must be
  41.                          root.)
  42.  
  43.      --ii                  Change whether idle time  is  considered
  44.                          when  determining  the  availability  of
  45.                          this host.  (The caller must be root.)
  46.  
  47.      --ll                  Change  whether  load  average  is  con-
  48.                          sidered  when determining the availabil-
  49.                          ity of this host.  (The caller  must  be
  50.                          root.)
  51.  
  52.      --pp                  Process  migration  trace  records   are
  53.                          printed.   The  number of records may be
  54.                          altered by the --PP option.
  55.  
  56.      --PP _n_u_m_R_e_c_s          The number of trace records to print  is
  57.                          modified  to  be  _n_u_m_R_e_c_s.   This option
  58.                          must be used with the --pp option.
  59.  
  60.  
  61.  
  62.  
  63. Sprite v.1.0         Printed:  March 8, 1990                    1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. MIGCMD                    User Commands                    MIGCMD
  71.  
  72.  
  73.  
  74.      --tt                  Process migration tracing is enabled for
  75.                          the current host.
  76.  
  77.      --TT                  Process migration  tracing  is  disabled
  78.                          for the current host.
  79.  
  80.      --dd _d_e_b_u_g_L_e_v_e_l       The kernel process migration debug level
  81.                          is set to _d_e_b_u_g_L_e_v_e_l.
  82.  
  83.      --VV _m_i_g_r_a_t_i_o_n_V_e_r_s_i_o_n The kernel process migration version  is
  84.                          set  to  _m_i_g_r_a_t_i_o_n_V_e_r_s_i_o_n.   The  caller
  85.                          must be root.
  86.  
  87. _________________________________________________________________
  88.  
  89. IINNTTRROODDUUCCTTIIOONN
  90.      This command is used to perform functions related to process
  91.      migration.   MMiiggccmmdd  is normally used to print the status of
  92.      process  migration  availability  or  migration  statistics.
  93.      MMiiggccmmdd  may  also be used to restrict which users may export
  94.      or import processes from or to the local  host  (the  caller
  95.      must  be  root to do so); change whether load average and/or
  96.      idle time are considered when deciding whether  the  current
  97.      host is available for imports; print process migration trace
  98.      records; enable or  disable  tracing  of  process  migration
  99.      activity;  or set the kernel's migration ``debugging level''
  100.      or ``migration version''.
  101.  
  102. MMIIGGRRAATTIIOONN SSTTAATTEE
  103.      MMiiggccmmdd prints the status of process  migration  availability
  104.      if  the  --ss  flag is specified.  As root, one may modify the
  105.      restrictions on process migration.  For both  exporting  and
  106.      importing  processes,  root may choose to restrict migration
  107.      to processes owned by root, or not allow migration  at  all,
  108.      or  allow all users to migrate.  These options are specified
  109.      to the --EE and --II flags as rroooott, nnoonnee, and aallll  respectively.
  110.      In  addition, root is permitted to instruct the llooaaddaavvgg dae-
  111.      mon whether to consider idle time and/or load  average  when
  112.      announcing  the  availability  of  the host for importation.
  113.      These options are --ii  and  --ll,  respectively,  and  take  an
  114.      integer  argument:  11 specifies that the criterion should be
  115.      ignored, and 00 specifies that it should be considered.
  116.  
  117. SSTTAATTIISSTTIICCSS
  118.      The --SS flag causes MMiiggccmmdd  to print statistics on its  stan-
  119.      dard  output.   These  statistics change too rapidly to list
  120.      the  format  here.   The   format   is   (hopefully)   self-
  121.      explanatory.
  122.  
  123. TTRRAACCIINNGG
  124.      The --pp flag may be used  to  dump  process  migration  trace
  125.      records.   The maximum number of records defaults to 200 but
  126.      may be modified with the --PP option.  By default, tracing  is
  127.      disabled  and  no  trace records will be printed.  To enable
  128.  
  129.  
  130.  
  131. Sprite v.1.0         Printed:  March 8, 1990                    2
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138. MIGCMD                    User Commands                    MIGCMD
  139.  
  140.  
  141.  
  142.      tracing, one may specify the --tt flag, and to disable it, one
  143.      may specify the --TT flag.
  144.  
  145. MMIIGGRRAATTIIOONN DDEEBBUUGG LLEEVVEELL
  146.      The kernel's debug  level  may  be  modified  using  the  --dd
  147.      option.  Subsequently higher values for the debug level will
  148.      cause more debugging statements to be executed. For example,
  149.      to have no migration debugging enabled whatsoever, the level
  150.      may be set to 0.  To enable  error  messages  that  indicate
  151.      unusual  but  non-fatal  events, the level may be 2 (this is
  152.      the current default).  To enable  more  messages  about  the
  153.      internal  operation  of migration within the kernel, such as
  154.      forwarded system calls, the level may be set to values  from
  155.      3-10.  ``Less interesting'' events are conditioned on higher
  156.      values of the debug level.
  157.  
  158. MMIIGGRRAATTIIOONN VVEERRSSIIOONN
  159.      The kernel's migration version may be modified by root using
  160.      the --VV  option.  This should be done only when the kernel is
  161.      compiled with an incorrect version for some reason, in order
  162.      to  cause  the  kernel  to be compatible vis-a-vis migration
  163.      with a different class of kernels.
  164.  
  165. SSEEEE AALLSSOO
  166.      mig
  167.  
  168. KKEEYYWWOORRDDSS
  169.      debug level, eviction, process migration, remote execution
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197. Sprite v.1.0         Printed:  March 8, 1990                    3
  198.  
  199.  
  200.  
  201.